package cn.iocoder.yudao.module.api.promotion.coupon;

import cn.iocoder.yudao.module.api.promotion.coupon.dto.CouponTemplateRespDTO;
import jakarta.annotation.Nonnull;

import java.util.List;
import java.util.Map;
import java.util.Set;

/**
 * 优惠劵模板 API 接口
 *
 * @author 山野羡民
 */
public interface CouponTemplateApi {

    /**
     * 获得店铺的优惠劵模板列表
     *
     * @param shopId 用户编号
     * @return 优惠劵模板列表
     */
    @Nonnull
    List<CouponTemplateRespDTO> getCanTakeCouponTemplateListByShopId(Long shopId);

    /**
     * 获得店铺的优惠劵模板 Map
     *
     * @param shopIds 店铺编号集合
     * @return 优惠劵模板 Map
     */
    @Nonnull
    Map<Long, List<CouponTemplateRespDTO>> getCanTakeCouponTemplateMap(Set<Long> shopIds);

    /**
     * 校验优惠劵模板是否可用
     *
     * @param id 优惠劵模板编号
     * @return 优惠劵模板
     */
    CouponTemplateRespDTO validateTemplate(Long id);

}
